home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma21.dms / ma21.adf / Most 1.53 / Doks / Most.dok.pp / Most.dok
Text File  |  1994-03-15  |  33KB  |  1,135 lines
  1.                       Dokumentation zu Most V1.53
  2.  
  3.                         Datum: 28. Januar 1994
  4.  
  5.                             Autor: Uwe Röhm
  6.  
  7.       Most ist ein Textanzeiger ähnlich Less, More oder MuchMore.
  8.  
  9.    Most bietet
  10.  
  11.    -     beliebig viele Textfenster
  12.  
  13.    -     verteiltes Prozeßsystem
  14.  
  15.    -     Suchfunktion
  16.  
  17.    -     frei konfigurierbar
  18.  
  19.    -     Kopiermöglichkeit ins Clipboard
  20.  
  21.    -     Einladen von Dateien per Doppelklick
  22.  
  23.    -     Fontsensitive Oberfläche
  24.  
  25.    -     PubScreen, eigenen Bildschirm oder Workbench
  26.  
  27.    -     AppWindow, AppIcon
  28.  
  29.    -     ARexx Unterstützung
  30.  
  31.    -     Sprachanpassung per locale.library
  32.  
  33.    -     XPK Unterstützung
  34.  
  35.    -     Verwendung mit Pipes
  36.  
  37.    -     Hilfe per AmigaGuide
  38.  
  39.    -     benötigt Kickstart 2.0 oder höher!
  40.  
  41. Most V1.53
  42. **********
  43.  
  44.                       Dokumentation zu Most V1.53
  45.  
  46.                 Datum: 28. Januar 1994  Autor: Uwe Röhm
  47.  
  48. Copyright
  49. *********
  50.  
  51.    Am Anfang standen Schweiß und Mühe. Also sprach der Programmierer:
  52. Es werde Giftware! Und so war es.
  53.  
  54.    Most 1.53 ist Giftware und darf frei kopiert und benutzt werden. Ich
  55. würde mich aber über Geschenke jeglicher Art von den Benutzern, die
  56. Most regelmäßig verwenden, sehr freuen.
  57.  
  58.    Davon abgesehen behalte ich mir mein Copyright aber vor, also:
  59.  
  60.                    Copyright (C) 1992/93/94 Uwe Röhm
  61.  
  62.    Ich verbiete ausdrücklich, daß Most kommerziellen Produkten ohne
  63. meine Zustimmung beigelegt wird. Insbesondere darf Most nicht für
  64. militärische Zwecke im weitesten Sinne verwendet werden. Im weitesten
  65. Sinne heißt, daß ich auch den Verwaltungen und sonstigen Büros
  66. solcher Firmen die Verwendung untersage, die militärische Produkte
  67. auch nur planen oder unterstützen (Hersteller sowieso).
  68.  
  69.    Most darf in PD Sammlungen aufgenommen werden, solange jene nicht
  70. mehr als umgerechnet 10 DM kosten. Das ist das absolute Maximum! Ich
  71. verlange aber, daß Most immer vollständig, also insbesondere immer
  72. zusammen mit der Dokumentation verbreitet wird. Das gilt auch für
  73. jeden normalen Benutzer! Leute, denkt an die Doku - ohne die ist ein
  74. Programm nur die Hälfte wert!
  75.  
  76. Prinzip
  77. *******
  78.  
  79.    Ich habe Most geschrieben, da ich eine Textanzeiger haben wollte, der
  80. auf der Workbench aufgeht und sowohl über die Tastatur als auch die
  81. Maus vollständig zu bedienen ist. Außerdem sollte er möglichst
  82. flexibel sein und insbesondere auch mit wenig Speicher auskommen.
  83.  
  84.    Deshalb arbeitet Most immer mit einem Fenster, in dem der Text
  85. angezeigt wird. Wer will, kann jenes aber auch auf anderen Bildschirm
  86. öffnen lassen. Most kann sogar einen eigenen Bildschirm öffnen.
  87. Wieviele Fenster Most auf hat, wo jene liegen (welcher PubScreen) und
  88. welche Texte darin zu sehen sind hängt nur vom Speicher und dem
  89. Benutzer ab :-)
  90.  
  91.    Jeder Text hat nicht nur sein eigenes Fenster, sondern dahinter
  92. steht auch ein eigener Prozeß. Damit sind die Textfenster voneinander
  93. völlig autonom.  Insbesondere können ARexx Befehle an verschiedenen
  94. Texte gleichzeitig gesendet werden und es ist immer möglich, neue
  95. Fenster zu öffnen, auch wenn die bereits geöffneten gerade
  96. "beschäftigt" sind. Dazu gibt es einen Most Hauptprozess, der die Texte
  97. verwaltet und einige globale ARexx Befehle behandelt (see Der ARexx
  98. Port).
  99.  
  100.    Um den Speicherverbrauch unter Kontrolle zu haben, arbeitet Most
  101. immer mit einem Puffer. Kleinere Texte, die vollständig in den Puffer
  102. passen, werden in einem Aufwasch eingelesen. Als Nebeneffekt wird die
  103. Textdatei nun nicht mehr benötigt und kann z.B. sofort weiter
  104. verändert werden.  Zu große Texte werden pufferweise gelesen. Das
  105. spart Speicherplatz (man wähle kleine Puffergrößen), bringt aber
  106. weniger Komfort (sprich Zeiteinbuße) beim Scrollen und Suchen.
  107. Außerdem blockiert Most nun den Text, so daß er nicht verändert
  108. werden kann, solange Most in anzeigt.
  109.  
  110.    Dieses "Paging" großer Dateien ist sehr nützlich, wenn man wenig
  111. Speicher oder übergroße Dateien hat. Wer es nicht haben will braucht
  112. nur die Puffer- größe sehr sehr groß machen (sagen wir mal 4 MB),
  113. womit wohl alle normalen Textdateien auf einen Schwung einlesbar sind.
  114. Keine Angst, Most verwendet dann natürlich nur soviel Speicher, wie
  115. die Datei groß ist :-))
  116.  
  117.    Eine Ausnahme des Pagings sind XPK-gepackte Dateien, die der
  118. Einfachheit halber immer vollständig eingelesen werden. Für sie gibt
  119. es also kein Paging! (see XPK Schnittstelle)
  120.  
  121.    Natürlich kann Most Texte mit allen ANSI-Steuersequenzen anzeigen.
  122. Dafür habe ich das Rad nicht noch einmal erfunden, sondern auf
  123. Bewährtes zurückge- griffen: Das console.device. Als Nebeneffekt kann
  124. man Textstellen markieren und in das Clipboard kopieren. Leider hat
  125. dies auch drei Nachteile:
  126.    -  Man kann nur innerhalb der sichtbaren Seite markieren
  127.  
  128.    -  Das Scrollen ist auf Amigas ohne 680x0 (x >=2) relativ langsam ;-)
  129.  
  130.    -  Binäre Dateien sollte man NICHT einladen. Das gibt Chaos....
  131.  
  132. Konfiguration
  133. *************
  134.  
  135.    Most konfiguriert sich in der Reihenfolge
  136.  
  137.   1. Interne Vorgabewerte
  138.  
  139.   2. Environmentvariablen Most/Most und Most/FileReq (Bei Aufruf in
  140.      einer Shell werden lokale Variable zuerst eingelesen)
  141.  
  142.   3.      Bei Shell-Start: Shellparameter auswerten
  143.           Bei WB-Start   : Icon-Tooltypes auswerten
  144.  
  145.   4. NEU seit Most 1.53: Zu jedem Text wird - sofern vorhanden - dessen
  146.      Icon geöffnet und die Tooltypes ausgewertet. Die darin stehenden
  147.      Werte gelten dann lokal für das neue Fenster. Außerdem können
  148.      hier (und nicht im Most-Programmicon!) auch alle ARexx-Befehle
  149.      direkt eingetragen werden. Diese werden dann ebenfalls der Reihe
  150.      nach ausgeführt, quasi als eine Art "Tooltype-Skript" (see Der
  151.      ARexx Port).
  152.  
  153.    Folgende Optionen sind jeweils in 2.), 3.) und 4.) erlaubt:
  154.  
  155. FILES
  156. =====
  157.  
  158. Verwendung
  159.      Eine Liste von Dateien (nur beim Start aus einer Shell).  Es
  160.      können die bekannten AmigaDOS Wildcards verwendet werden.
  161.  
  162. PUBSCREEN
  163. =========
  164.  
  165. Verwendung
  166.      Zur Angabe eines Bildschirms, auf dem Most sein Fenster öffnet.
  167.  
  168. PORTNAME
  169. ========
  170.  
  171. Verwendung
  172.      Name des globalen ARexx Ports von Most (see Der ARexx Port).
  173.  
  174. Vorgabewert
  175.          MOSTPORT
  176.  
  177. STARTUP
  178. =======
  179.  
  180. Verwendung
  181.      Arexx Skript das beim Starten von Most ausgeführt wird (Achtung:
  182.      Dieses Skript wird auch beim Öffnen jedes weiteren Textfensters
  183.      ausgeführt!!) (see Der ARexx Port).
  184.  
  185.      Alternativ können in die Tooltypes der Text-Icons auch direkt
  186.      ARexx-Befehle geschrieben werden, die dann direkt nach dem Öffnen
  187.      des Textes der Reihe nach ausgeführt werden.
  188.  
  189. WINDOWX
  190. =======
  191.  
  192. Abkürzung
  193.          WX
  194.  
  195. Verwendung
  196.      Zur Angabe der X-Koordinate der Most-Fenster.
  197.  
  198. WINDOWY
  199. =======
  200.  
  201. Abkürzung
  202.          WY
  203.  
  204. Verwendung
  205.      Zur Angabe der Y-Koordinate der Most-Fenster. -1 zentriert die
  206.      Fenster.
  207.  
  208. WINDOWW
  209. =======
  210.  
  211. Abkürzung
  212.          WW
  213.  
  214. Verwendung
  215.      Die Breite der Fenster angeben.
  216.  
  217. Vorgabewert
  218.      600
  219.  
  220. WINDOWH
  221. =======
  222.  
  223. Abkürzung
  224.          WH
  225.  
  226. Verwendung
  227.      Zur Angabe der Fensterhöhe.
  228.  
  229. Vorgabewert
  230.      400
  231.  
  232. SCREENMODE
  233. ==========
  234.  
  235. Abkürzung
  236.          SM
  237.  
  238. Verwendung
  239.      Der Name einer Bildschirmauflösung, die dem Betriebssystem
  240.      bekannt ist (Most verwendet keine fest einprogrammierte
  241.      Namensliste). Eine Liste dieser Namen sieht man zum Beispiel im
  242.      Fenster des Prefs/ScreenMode Programms. Wird ein gültiger Modus
  243.      angegeben, so öffnet Most einen eigenen Bildschirm (Name: Most),
  244.      auf dem seine Fenster liegen.  Achtung: Je nach Version der
  245.      Monitordateien ändern sich eventuell die Namen der Auflösungen.
  246.  
  247. Beispiel
  248.              SCREENMODE "Pal:HighRes"
  249.  
  250. FONT
  251. ====
  252.  
  253. Verwendung
  254.      Der Name des gewünschten Zeichensatzes für den Text inklusive
  255.      der Endung ".font". Achtung mit Proportionalfonts!
  256.  
  257. Beispiel
  258.              FONT "helvetica.font"
  259.  
  260. FONTHEIGHT
  261. ==========
  262.  
  263. Verwendung
  264.      Hiermit kann die Höhe des eigenen Zeichensatzes angegeben werden.
  265.      Wird die Höhe nicht explizit angegeben, so wird die Höhe des
  266.      Standard-System-Fonts kopiert. Diese Option wirkt nur in
  267.      Zusammenhang mit der Option FONT.
  268.  
  269. APPICON
  270. =======
  271.  
  272. Verwendung
  273.      Das AppIcon von Most wird mit diesem Schalter angeschaltet.  Wird
  274.      diese Option ohne weitere Dateinamen angegeben, so startet Most im
  275.      Hintergrund nur mit dem AppIcon.
  276.  
  277. ICONX
  278. =====
  279.  
  280. Verwendung
  281.      Die X-Koordinate vom APPICON auf der Workbench.
  282.  
  283. ICONY
  284. =====
  285.  
  286. Verwendung
  287.      Die X-Koordinate für das APPICON auf der Workbench.
  288.  
  289. BUFLEN
  290. ======
  291.  
  292. Verwendung
  293.      Hiermit läßt sich die maximale Länge des Lesespeichers angeben.
  294.      Für kleiner Dateien wird nur ein Puffer von der Länge der Datei
  295.      allokiert. Dadurch kann mit sehr großen Puffergrößen erzwungen
  296.      werden, alle Dateien vollständig einzuladen.
  297.  
  298. Vorgabewert
  299.      50 000 Bytes
  300.  
  301. PIPELEN
  302. =======
  303.  
  304. Verwendung
  305.      Most kann auch aus einer Pipe lesen. Normalerweise werden dann
  306.      fest BUFLEN/10 Bytes zum Lesen belegt.  Mit dieser Option kann man
  307.      die Speichergröße für Pipes explizit setzen.
  308.  
  309. Beispiel
  310.              PIPELEN 8192
  311.  
  312. QUOTES
  313. ======
  314.  
  315. Verwendung
  316.      Hiermit wird eine Folge von Trennzeichen definiert. Der Sinn
  317.      dahinter ist die Möglichkeit, mit Doppelklick auf ein Wort, das
  318.      zwischen den hiermit angegebenen Trennern steht, einen Text mit
  319.      dem entsprechenden Namen zu laden. Das ist besonders für
  320.      Programmierer gedacht, die somit leicht die Inklude-Dateien in
  321.      ihren Sourcen anspringen können.
  322.  
  323. Vorgabe
  324.      "'<>(){}[]
  325.  
  326. DIRS
  327. ====
  328.  
  329. Verwendung
  330.      Hiermit können mehrere Pfade angegeben werden, die der Reihe nach
  331.      durchsucht werden, wenn Most nach einem Doppelklick in den Text
  332.      Inklude-Dateien einzuladen versucht (siehe QUOTES). Die einzelnen
  333.      Pfade werden durch das Zeichen | voneinander getrennt.
  334.  
  335. Beispiel
  336.              DIRS "Include:|TexInputs:|LC:Include/"
  337.  
  338. ENDS
  339. ====
  340.  
  341. Verwendung
  342.      Endungen, die automatisch an Inklude-Dateien (der Reihe nach)
  343.      angehängt    werden (vgl. DIRS, QUOTES).
  344.  
  345. Beispiel
  346.              ENDS ".c.h.tex"
  347.  
  348. STACKSIZE
  349. =========
  350.  
  351. Verwendung
  352.      Dient dazu, um dem Editor, der mit dem aktuellen Text gestartet
  353.      werden    kann, eine bestimmte Stackgröße einzustellen. Dies ist
  354.      zum Beispiel    für den Emacs ("Eight Megabytes And Constantely
  355.      Swapping"?) nützlich.
  356.  
  357. Beispiel
  358.              STACKSIZE 50000
  359.  
  360.  
  361. Vorgabe
  362.      8192 Bytes
  363.  
  364. Tastenbefehle
  365. *************
  366.  
  367.    Grundsätzlich werden alle von More her bekannten Tastenkommandos
  368. unterstützt.  Die Befehle unterteilen sich in folgende Bereiche:
  369.  
  370. Scrollen
  371. ========
  372.  
  373. eine Zeile tiefer
  374.          CURSOR RUNTER, ZIFFERBLOCK 2, RETURN, ENTER
  375.  
  376. eine Zeile hoch
  377.          CURSOR HOCH, ZIFFERBLOCK 8, DELETE
  378.  
  379. eine Seite weiter springen
  380.          SHIFT CURSOR RUNTER, SPACE, PAGE DOWN
  381.  
  382. Eine Seite zurück springen
  383.          SHIFT CURSOR HOCH, BACKSPACE, PAGE UP, b
  384.  
  385. Zum Textanfang springen
  386.          HOME, <
  387.  
  388. Zum Textende springen
  389.          END, >
  390.  
  391. Eine Spalte nach rechts
  392.          CURSOR RECHTS, ZIFFERBLOCK 6
  393.  
  394. Eine Spalte nach links
  395.          CURSOR LINKS, ZIFFERBLOCK 4
  396.  
  397. 8 Spalten nach rechts
  398.          SHIFT CURSOR RECHTS
  399.  
  400. 8 Spalten nach links
  401.          SHIFT CURSOR LINKS
  402.  
  403. Suchbefehle
  404. ===========
  405.  
  406. Bisherigen Suchbegriff weiter suchen (vorwärts)
  407.          n
  408.  
  409. Suchen ohne auf Groß/Kleinschrift zu achten
  410.          .
  411.  
  412. Suchen mit Unterscheidung nach Groß/Kleinschrift
  413.          /
  414.  
  415. Das Suchfenster öffnen
  416.          f, s
  417.  
  418. Laden
  419. =====
  420.  
  421.    Neuen Text laden mit l (Dateiauswahlfenster erscheint).
  422.  
  423. Informationsfenster
  424. ===================
  425.  
  426.    Neben dem üblichen Copyright stehen hier nähere Informationen zum
  427. aktuellen Text: Der Dateiname, die Dateigröße, die Zeilenzahl und die
  428. davon gerade sichtbaren Zeilen, sowie der Name des XPK Packers (oder
  429. einfach nur "---" wenn die Datei ungepackt ist). Hier erscheint auch
  430. entweder die Meldung, daß der Text komplett eingelesen wurde, oder die
  431. Größe des benutzten Lesespeichers.
  432.  
  433.    Das Informationsfenster öffnen Sie mit h.
  434.  
  435. Hilfe
  436. =====
  437.  
  438.    Wenn Sie HELP drücken, wird der AmigaGuide mit der Beschreibung
  439. von Most gestartet. Dazu muß natürlich der AmigaGuide installiert
  440. sein. Wenn Most die amigaguide.library nicht öffnen kann, dann
  441. erscheint stattdessen das Informationsfenster.
  442.  
  443.    Der AmigaGuide sucht seine Dokumente im aktuellen Verzeichnis und in
  444. allen Pfaden, die in der Environment Variablen AmigaGuide/Path
  445. aufgelistet sind.
  446.  
  447. Editieren
  448. =========
  449.  
  450.    Wenn Sie e drücken, wird der Text in einen Editor geladen.  Der
  451. Editor wird asynchron gestartet. Den Namen des Editors erwartet Most in
  452. der Environmentvariablen EDITOR.
  453.  
  454. Beenden
  455. =======
  456.  
  457.    Das Textfenster wird mit ESCAPE, CTRL-C oder q geschloßen.
  458.  
  459. Menus
  460. *****
  461.  
  462.    Es gibt folgende Hauptmenüs in Most:
  463.  
  464. Projekt
  465. =======
  466.  
  467. Neu...
  468.      Öffnet ein neues Fenster und fragt per Dateiauswahlfenster nach
  469.      einer neuen Datei. Wenn der Dateiauswahlfenster abgebrochen wird,
  470.      so wird das Fenster wieder geschloßen.
  471.  
  472. öffnen...
  473.      Per Dateiauswahlfenster den Namen einer neuen Textdatei auswählen
  474.      und in das aktuelle Fenster laden. Die Ausmaße, Koordinaten und
  475.      das Pattern des Dateiauswahlfensters können im Einstellungen
  476.      Menü abgespeichert werden.
  477.  
  478. editieren...
  479.      Startet den Editor mit dem aktuellen Text (per RUN). Der Name des
  480.      Editors muß in der Environment Variable EDITOR stehen.
  481.  
  482. drucken
  483.      Druckt den aktuellen Text über den Systemdruckertreiber (PRT:)
  484.      aus.
  485.  
  486. Info...
  487.      Öffnet ein Informationsfenster, in dem neben dem üblichen
  488.      Copyright einige wichtige Informationen zum aktuellen Text stehen:
  489.      Name, Dateilänge, Zeilenzahl, sichtbare Zeilennummern,
  490.      XPK-Packername und entweder die Meldung, daß der Text
  491.      komplett eingelesen wurde, oder die Größe des benutzten Puffers.
  492.  
  493. Ende
  494.      Beendet den aktuellen Text und -- falls es der letzte Text ist --
  495.      auch ganz Most.
  496.  
  497. Bewegen
  498. =======
  499.  
  500.    Verschiedene Menüpunkte zum zeilen- und seitenweisen Springen im
  501. Text, bzw.  um gezielt die letzte oder erste Seite anzuspringen.
  502.  
  503.    Mit dem Menü "zu Zeile ..." kann man in einem Dialogfenster eine
  504. bestimmte Zeilennummer eingeben, zu der man im Text Springen möchte.
  505. Most macht nichts, wenn die eingegebene Nummer ungültig ist (kleiner 1
  506. oder zu groß).
  507.  
  508. Suchen
  509. ======
  510.  
  511. suchen...
  512.      Das Suchfenster wird geöffnet und aktiviert dessen
  513.      Texteingabefeld. Bei bereits offenem Requester ist dieser
  514.      Menüpunkt inaktiviert.
  515.  
  516. vorwärts/rückwärts
  517.      Suchen des eingegebenen Suchtextes in die jeweilige Richtung.
  518.      Beide Punkte sind anwählbar, wenn das Suchfenster geöffnet ist.
  519.  
  520. Extras
  521. ======
  522.  
  523. Bild neu aufbauen
  524.      Initialisiert die Console neu und baut die aktuelle Seite noch
  525.      einmal vollständig auf.
  526.  
  527. Tabulatorbreite einstellen...
  528.      Öffnet ein Fenter, in dem die Breite der Tabulatoren eingegeben
  529.      werden kann. Normalerweise sind die Tabulatoren alle 8 Zeichen
  530.      gesetzt.
  531.  
  532. Skript starten...
  533.      Öffnet einen Dateiauswahlfenster, mit dem ein ARexx Makro
  534.      ausgewählt werden kann, das anschließend ausgeführt wird.
  535.  
  536. Einstellungen
  537. =============
  538.  
  539. sichern
  540.     global
  541.           Speichern der momentanen Einstellungen in Env: und EnvArc: in
  542.           ein Unterverzeichnis Most (das automatisch erzeugt wird).
  543.           Es werden alle von der Kommandozeile bekannten Optionen
  544.           gespeichert.  Zusätzlich werden in einer extra Variablen die
  545.           Maße, die Position und das Pattern des Dateiauswahlfensters
  546.           abgespeichert.
  547.  
  548.     lokal
  549.           Speichern der Einstellungen in zwei lokale Shell Variablen
  550.           namens Most/Most und Most/FileReq (sorry wegen den
  551.           Namen...). Diese Option funktioniert natürlich nur, wenn
  552.           Most von einer Shell aus gestartet worden ist!
  553.  
  554. Das Textfenster
  555. ***************
  556.  
  557. Titelzeile
  558.      Links steht der Dateiname, möglichst weit rechts wird die
  559.      aktuelle Spalten- und Zeilennummer der obersten (sichtbaren) Zeile
  560.      angegeben.  Format:
  561.            <Dateiname>                               <Spalte>/<Zeile>
  562.  
  563. Symbole
  564.      Neben den bekannten Systemsymbolen zum Schließen, Verkleinern usw.
  565.      gibt es drei weitere Symbole am rechten Fensterrand, mit denen im
  566.      Text gescrollt werden kann.  Der Scrollbalken kann sowohl frei
  567.      bewegt, als auch durch hineinklicken seitenweise benutzt werden.
  568.      Die Balkenposition gibt die Position im Text, seine Größe das
  569.      Verhältnis der sichtbaren Seite zum ganzen Text an.  Die beiden
  570.      Pfeilsymbole darunter dienen zum zeilenweisen Auf- und Abscrollen.
  571.  
  572. Maussteuerung
  573.      Wir mit der Maus in das Fenster doppelt geklickt, so wird an der
  574.      entsprechenden Stelle nach einem Dateinamen zwischen den
  575.      konfigurierten Trennzeichen (see QUOTES) gesucht. Ist dort eine
  576.      solche Textstelle vorhanden (z.B. in C-Sourcen ein "#include
  577.      <exec/exec.h>" mit dem Dateinamen exec/exec.h zwischen "<" und
  578.      ">"), dann wird jener in allen konfigurierten Verzeichnissen (vgl.
  579.      DIRS) gesucht und sofern gefunden in einem eigenen Fenster
  580.      angezeigt.
  581.  
  582. Clipboard
  583.      Es kann aus den Fenstern durch das einfache Anklicken des Textes
  584.      und dem anschließenden Bewegen der Maus (ohne den linken Knopf
  585.      loszulassen!) ein Textbereich im Fenster markiert werden. Der
  586.      markierte Textbereich kann dann mit AMIGA-C kopiert werden.
  587.  
  588. AppWindow
  589.      Jedes Most-Textfenster ist ein sogenanntes AppWindow, in das
  590.      jederzeit eines oder auch mehrere Icons gezogen werden können.
  591.      Die erste Datei wird dann in das aktuelle Fenster eingeladen und
  592.      für alle weiteren Dateien werden eigene Fenster geöffnet.
  593.  
  594. Das Suchfenster
  595. ***************
  596.  
  597.    Im Suchfenster kann ein Suchbegriff eingegeben, sowie die drei
  598. Suchoptionen eingestellt werden. Dies geht sowohl mit der Maus als auch
  599. per Tastatur. Die entsprechenden Buchstabenabkürzungen sind in den
  600. Symboltexten unterstrichen.  Außerdem hat man im Suchfenster die
  601. gleiche Funktionalität wie im zugehörigen Textfenster:
  602.  
  603.    - Es sind dieselben Menüs und deren Shortcuts vorhanden. Lediglich
  604.      der Menüpunkt Suchen ist abgeschaltet und dafür die Punkte
  605.      vorwärts/rückwärts suchen zugelassen.
  606.  
  607.    - Neben den speziellen Tastenbefehlen für die Symbole des
  608.      Suchfensters werden alle Tastenbefehle des Textfensters
  609.      weiterhin unterstützt.  Insbesondere kann man also bei
  610.      aktiviertem Suchfenster mit den Cursortasten im Textfenster
  611.      scrollen!!! (Achtung: Das geht nur bei inaktivem Texteingabefeld)
  612.  
  613. Das AppIcon
  614. ***********
  615.  
  616.    Das AppIcon erlaubt zwei Funktionen:
  617.  
  618. Doppelklick
  619.      Ein Dateiauswahlfenster erscheint, in dem eine Datei ausgewählt
  620.      werden kann.  Ist nur noch das AppIcon von Most aktiv (das heißt
  621.      keine Textfenster offen) und wird nun das Auswahlfenster
  622.      abgebrochen, so wird damit Most beendet (vorher kommt natürlich
  623.      noch eine Sicherheitsabfrage)!
  624.  
  625. Icons
  626.      Werden Piktogramme auf das AppIcon gezogen, so werden jene
  627.      angezeigt.
  628.  
  629.    Bemerkungen:
  630.      Most verwendet immer das eigene Piktogramm als APPICON! Ein
  631.      eingebautes Bild bzw. ein explizit angegebenes werden nicht
  632.      angeboten/unterstützt.  Die Koordinaten des AppIcons werden im
  633.      Menü Einstellungen mit abgespeichert. Mit den Optionen ICONX und
  634.      ICONY können explizite Koordinaten angegeben werden.
  635.  
  636. XPK Schnittstelle
  637. *****************
  638.  
  639.    Die Schnittstelle zum XPK Standard ist absolut transparent, um
  640. nicht zu sagen, unsichtbar gehalten. Ist eine Datei mit einem XPK
  641. Packer gepackt und ist das XPK Packet korrekt installiert, so
  642. entpackt Most die Datei automatisch und zeigt sie dann an. Im
  643. Informationsfenster erscheint nun hinter "XPK-Packer:" nicht mehr wie
  644. üblich "---", sondern der Name des verwendeten Packers.  Einzige
  645. Besonderheit: Die Datei wird vollständig eingeladen, ein "Paging"
  646. findet nicht statt!
  647.  
  648.    Trifft Most auf eine mit XPK verschlüsselte Datei, dann öffnet
  649. er erst ein Passwort-Dialogfenster, in dem man sein Passwort angeben
  650. kann. Aber Vorsicht: Man hat nur diese eine Gelegenheit! Gibt man ein
  651. falsches Passwort an, sieht man den verschlüsselten Kauderwelch und
  652. muß den Text erneut laden.
  653.  
  654.    Most kann ohne Probleme auch ohne XPK verwendet werden. Die
  655. xpkmaster.library ist also nicht nötig, um mit Most Texte anzuzeigen.
  656. Ohne sie werden XPK gepackte Texte dann natürlich auch nicht
  657. entpackt...
  658.  
  659. Pipe Verwendung
  660. ***************
  661.  
  662.    Neuerdings unterstützt Most auch Pipes. Diese Option ist aber immer
  663. noch wenig getest. Bitte meldet mir alle Fehler.
  664.  
  665.    Wurde Most zum Beispiel mit
  666.      type xyz | Most
  667.    gestartet, dann öffnet es ein Textfenster Namens <Pipe Inhalt>
  668. und zeigt den Inhalt der Pipe an. Ist jener kleiner als die
  669. konfigurierte Puffergröße, dann kann ganz normal darin gescrollt
  670. werden (editieren funktioniert aber nicht!). Ist der Puffer zu klein
  671. und scrollt man über den Puffer hinaus, so wird zwar weitergelesen,
  672. ein zurück zum Dateinanfang gibt es jetzt aber nicht mehr. Wie üblich
  673. kann man Most natürlich einen größeren Puffer mitgeben...
  674.  
  675.    Kleine Einschränkungen:
  676.  
  677.    Der Puffer wird mit einer Größe von  BUFLEN / 10 angelegt (wie
  678. soll man einer Pipe entlocken, wieviel sie enthält/enthalten wird?).
  679. Mit der Option PIPELEN kann man explizit die Speichergröße für Pipes
  680. festlegen.
  681.  
  682.        XPK aus einer Pipe ist nicht möglich.
  683.  
  684. Der ARexx Port
  685. **************
  686.  
  687.    Neben dem globalen ARexx-Port MOSTPORT (bzw. der durch die Option
  688. PORTNAME angegebene Name) des Hauptprozesses von Most besitzt jedes
  689. Textfenster seinen eigenen ARexx Port. Um einen spezielles Textfenster
  690. anzusprechen, sendet man an den globalen ARexx Port zuerst den Befehl
  691. GetFileList, der eine Liste aller geöffneten Texte und deren Portnamen
  692. zurückgibt. Anhand jener Liste kann dann das gewünschte Fenster direkt
  693. addressiert werden. Während man an die Ports der einzelnen Fenster
  694. alle Arexx-Befehle senden kann, "versteht" der Hauptport nur die
  695. ersten 6 Befehle GetFileList, GetScreenName, Quit, OpenNew, Set und
  696. Request.
  697.  
  698.    Most setzt in RC eine Fehlernummer von
  699.    *    0, wenn der Befehl korrekt ausgeführt wurde.
  700.  
  701.    *    5, wenn Open oder OpenNew fehlschlugen
  702.  
  703.    *    10, bei Fehlern in den Parametern zu einem Befehl.
  704.  
  705.    *    20, falls ein unbekanntes Befehlswort gesendet wurde.
  706.  
  707.    Folgende ARexx Befehle werden unterstützt:
  708.  
  709. GetFileList
  710. ===========
  711.  
  712. Aufruf
  713.      GetFileList
  714.  
  715. Resultat
  716.      In RESULT wird eine Liste aller vorhandenen Textfenster und ihrer
  717.      Portnamen zurückgegeben. RESULT hat den Aufbau: {<Fenstername>
  718.      <Portname> }^+ (das heißt mindestens einmal aber beliebig viele)
  719.  
  720. Beispiel
  721.              GetFileList
  722.              RESULT: "Most.dok MOST.0 Most.doc MOST.1"
  723.  
  724. GetScreenName
  725. =============
  726.  
  727. Aufruf
  728.      GetScreenName
  729.  
  730. Resultat
  731.          RESULT enthält den Schirmnamen
  732.  
  733. Wirkung
  734.      Liefert den Namen des Bildschirms, auf dem Most den aktuellen Text
  735.      darstellt.
  736.  
  737. Beispiel
  738.              GetScreenName
  739.              RESULT - "Workbench"
  740.  
  741. Quit
  742. ====
  743.  
  744. Aufruf
  745.      Quit
  746.  
  747. Wirkung
  748.      Beendet Most und schließt alle Fenster. Das AppIcon von Most
  749.      wird auch entfernt - sofern vorhanden.
  750.  
  751. Beispiel
  752.              Quit
  753.  
  754. Request
  755. =======
  756.  
  757. Aufruf
  758.      Request TITLE/K/A TEXT/K/A GADGETS/K/A
  759.  
  760. Resultat
  761.          RESULT enthält Nummer des gedrückten Gadgets:
  762.  
  763.     0
  764.           das am weitesten rechts (meist Abbrechen)
  765.  
  766.     1 bis n-1
  767.           die restlichen von links durchnummeriert
  768.  
  769. Wirkung
  770.      Eine einfache Möglichkeit einer Benutzerabfrage per Dialogfenster.
  771.      Titel und Text sind einfache Strings. Mit GADGETS werden die
  772.      Texte der Gadgets angegeben, durch '|' getrennt.
  773.  
  774. Beispiel
  775.              Request TITLE "Test" TEXT "Klaro?" GADGETS "JA|Nein"
  776.              RESULT - 1 wenn JA gewählt wurde, sonst 0
  777.  
  778. Set
  779. ===
  780.  
  781. Aufruf
  782.      Set CASE/S WORD/S BACK/S
  783.  
  784. Wirkung
  785.      Durch das Angeben eines der Schlüsselworte wird die entsprechende
  786.      Option angeschaltet, während die Optionen, die nicht angegeben
  787.      wurden, implizit ausgeschaltet werden. Die Parameter bedeuten
  788.  
  789.     CASE
  790.           casesensitives Suchen an
  791.  
  792.     WORD
  793.           wortweises Suchen an
  794.  
  795.     BACK
  796.           Rückwärtssuchen an
  797.  
  798. Beispiel
  799.              Set WORD ON
  800.              Das wortweise Suchen wird an-, die anderen beiden Suchoptionen ausgeschaltet.
  801.  
  802. OpenNew
  803. =======
  804.  
  805. Aufruf
  806.      OpenNew FILE/K
  807.  
  808. Wirkung
  809.      In ein eigene Fenster einen neuen Text laden. Die Angabe eines
  810.      Dateinamens ist optional. Wird er weggelassen, so wird ein
  811.      Dateiauswahlfenster geöffnet.
  812.  
  813.      Es braucht vorher kein aktuelles Fenster gewählt worden sein.
  814.      Das Kommando kehrt erst zurück, wenn der Text beendet wurde!
  815.  
  816. Beispiel
  817.              OpenNew FILE Most.dok
  818.  
  819. Open
  820. ====
  821.  
  822. Aufruf
  823.      Open FILE/K
  824.  
  825. Wirkung
  826.      In das aktuelle Fenster eine neue Datei einladen. Die Angabe eines
  827.      Dateinamens ist optional. Wird er weggelassen, so wird ein
  828.      Dateiauswahlfenster geöffnet. Das Kommando kehrt erst zurück,
  829.      wenn der Text beendet wurde!
  830.  
  831. Beispiel
  832.              Open FILE Most.dok
  833.  
  834. Close
  835. =====
  836.  
  837. Aufruf
  838.      Close
  839.  
  840. Wirkung
  841.      Schließt das aktuelle Fenster.
  842.  
  843. ToFront
  844. =======
  845.  
  846. Aufruf
  847.      ToFront
  848.  
  849. Wirkung
  850.      Holt das aktuelle Fenster nach vorne, so daß es vollständig
  851.      sichtbar wird.  Dazu wird auch der Bildschirm, auf dem sich das
  852.      Fenster befindet, nach vorne geholt und aktiviert.
  853.  
  854. GetWindowDims
  855. =============
  856.  
  857. Aufruf
  858.      GetWindowDims
  859.  
  860. Resultat
  861.      In RESULT steht <xpos> <ypos> <breite> <höhe>
  862.  
  863. Wirkung
  864.      Liefert die Ausmaße des akt. Fensters in RESULT
  865.  
  866. Beispiel
  867.              GetWindowDims
  868.              RESULT - "40 40 600 180"
  869.  
  870. Edit
  871. ====
  872.  
  873. Aufruf
  874.      Edit
  875.  
  876. Wirkung
  877.      Editieren des Textes des aktuellen Fensters  (Editor starten).
  878.  
  879. Info
  880. ====
  881.  
  882. Aufruf
  883.      Info
  884.  
  885. Wirkung
  886.      Öffnet das Informationsfenster zum aktuellen Text.
  887.  
  888. FirstPage
  889. =========
  890.  
  891. Aufruf
  892.      FirstPage
  893.  
  894. Wirkung
  895.      Die erste Seite des Textes anzeigen
  896.  
  897. LastPage
  898. ========
  899.  
  900. Aufruf
  901.      LastPage
  902.  
  903. Wirkung
  904.      Die letzte Seite des Textes anzeigen.
  905.  
  906. NextPage
  907. ========
  908.  
  909. Aufruf
  910.      NextPage
  911.  
  912. Wirkung
  913.      Nächste Seite des aktuellen Textes anzeigen.
  914.  
  915. PrevPage
  916. ========
  917.  
  918. Aufruf
  919.      PrevPage
  920.  
  921. Wirkung
  922.      Springt zur vorherigen Seite im Text.
  923.  
  924. NextLine
  925. ========
  926.  
  927. Aufruf
  928.      NextLine
  929.  
  930. Wirkung
  931.      Eine Zeile weiterscrollen
  932.  
  933. PrevLine
  934. ========
  935.  
  936. Aufruf
  937.      PrevLine
  938.  
  939. Wirkung
  940.      Eine Zeile zurückscrollen
  941.  
  942. NextColumn
  943. ==========
  944.  
  945. Aufruf
  946.      NextColumn
  947.  
  948. Wirkung
  949.      Eine Spalte nach rechts scrollen
  950.  
  951. PrevColumn
  952. ==========
  953.  
  954. Aufruf
  955.      PrevColumn
  956.  
  957. Wirkung
  958.      Eine Spalte nach links scrollen (bis maximal zum Textanfang)
  959.  
  960. NextTab
  961. =======
  962.  
  963. Aufruf
  964.      NextTab
  965.  
  966. Wirkung
  967.      Um 8 Spalten nach rechts scrollen
  968.  
  969. PrevTab
  970. =======
  971.  
  972. Aufruf
  973.      PrevTab
  974.  
  975. Wirkung
  976.      Um 8 Spalten nach links scrollen (bis maximal zum Textanfang)
  977.  
  978. Goto
  979. ====
  980.  
  981. Aufruf
  982.      Goto LINE/K/N/A COLUMN/K/N
  983.  
  984. Wirkung
  985.      Als Argument muß eine Zeile und optional kann die Startspalte
  986.      angegeben werden. Die Zeilennummer wird als neuer Seitenbeginn
  987.      genommen.
  988.  
  989. Beispiel
  990.              Goto LINE 142
  991.  
  992. Search
  993. ======
  994.  
  995. Aufruf
  996.      Search TEXT/K
  997.  
  998. Wirkung
  999.      Ohne Argument: Das Suchfenster öffnen, bzw. bereits eingegebenen
  1000.      Text weitersuchen
  1001.  
  1002.      Mit Suchbegriff: Als neuen Suchbegriff einsetzen und suchen.
  1003.  
  1004. Beispiel
  1005.              Search TEXT huhu
  1006.  
  1007. Bekannte Fehler
  1008. ***************
  1009.  
  1010.    - Verschiedene Kontrollsequenzen zum Setzen des Cursors sorgen für
  1011.      Chaos in der Anzeige.
  1012.  
  1013.    - Die Pipe Verwendung hat Probleme mit der WShell. Jene scheint immer
  1014.      nur zeilenweise in die Pipe zu schreiben, was Most
  1015.      fehlinterpretiert, da es weniger Daten liest als es wollte
  1016.      (nämlich seinen ganzen Pipe-Puffer voll). Sollte ich bei
  1017.      Gelegenheit mal ändern...
  1018.  
  1019. Kritiken - Ideen
  1020. ****************
  1021.  
  1022.    Most ist noch nicht ganz fertig. Es gibt ein paar Ecken und Kanten,
  1023. die ich noch abschleifen will. Der ARexx Port ist noch unvollständig
  1024. und die Einstellungen will ich noch teilweise mit Dialogfenstern
  1025. versehen (zum Beispiel für den Zeichensatz). Außerdem weicht Most
  1026. (also ich) in einigen Stellen von den Richtlinien des Style Guides ab:
  1027.  
  1028.    -    Keine Paste Option obwohl Copy möglich ist
  1029.  
  1030.    -    Menüstruktur
  1031.  
  1032.    -    keine Tastenbefehle mit CTRL oder ALT
  1033.  
  1034.    -    Speicherung der Einstellungen als pseudo Kommandozeile
  1035.  
  1036.    Ich bin sehr an Anregungen und auch jeglicher Kritik und Bugreports
  1037. interessiert! Schreibt mir, ruft mich an oder kommt vorbei, nur teilt
  1038. es mit mit :-)
  1039.  
  1040.    Meine Adresse:
  1041.         Uwe Röhm
  1042.         Wörthstr. 18
  1043.         94 032 Passau
  1044.  
  1045.    EMail:
  1046.         bugs@roemer.adsp.sub.org
  1047.  
  1048.    Fido:
  1049.         2:2494/22.5
  1050.  
  1051. aktuelle Version
  1052. ****************
  1053.  
  1054.    Die aktuellste Most Version ist immer per ftp auf
  1055. ftp.uni-passau.de (132.231.1.10) in  pub/amiga/local/UweR  zu
  1056. beziehen. Tip: In dem Verzeichnis pub/amiga/local liegen noch ganz
  1057. andere interessante Programme :-)
  1058.  
  1059.    Ich werde versuchen, die aktuellen Releases immer auf AmiNet
  1060. hochzuspielen.
  1061.  
  1062. Danksagungen
  1063. ************
  1064.  
  1065.    Besonderen Dank an meine Betatester
  1066.  
  1067.        David, Uli, Holger, Stefan und Stefan ;-)
  1068.        sowie Karl, den Unermütlichen
  1069.  
  1070.    Außerdem ein Dankeschön an Urban für seine Mühe und XPK.  Und
  1071. natürlich ein herzliches Dankeschön an alle, die mir Bugreports,
  1072. Übersetzungen und Vorschläge geschickt haben!
  1073.  
  1074. Index
  1075. *****
  1076.  
  1077.  
  1078.  
  1079.  XPK                                    XPK Schnittstelle
  1080.  AINSI Sequencen                        Prinzip
  1081.  aktuelle Version                       aktuelle Version
  1082.  AmigaGuide                             Hilfe
  1083.  Anregungen                             Kritiken - Ideen
  1084.  AppIcon                                Das AppIcon
  1085.  AppWindow                              Das Textfenster
  1086.  ARexx                                  Der ARexx Port
  1087.  Aufruf von Most                        Konfiguration
  1088.  Autor                                  Kritiken - Ideen
  1089.  Bewegen                                Bewegen
  1090.  Copyright                              Copyright
  1091.  Danksagungen                           Danksagungen
  1092.  Editieren                              Editieren
  1093.  Einstellungen                          Einstellungen
  1094.  Environment Variablen                  Konfiguration
  1095.  Extras                                 Extras
  1096.  Fehler                                 Bekannte Fehler
  1097.  Fenster                                Das Textfenster
  1098.  Fensterverwaltung                      Prinzip
  1099.  gepackte Dateien                       XPK Schnittstelle
  1100.  Giftware                               Copyright
  1101.  Hilfe                                  Hilfe
  1102.  Ideen                                  Kritiken - Ideen
  1103.  Includedateien anspringen              Das Textfenster
  1104.  Informationsfenster                    Informationsfenster
  1105.  Konfiguration                          Konfiguration
  1106.  Kritik                                 Kritiken - Ideen
  1107.  Makros                                 Extras
  1108.  Markieren                              Das Textfenster
  1109.  Maussteuerung                          Das Textfenster
  1110.  Menus                                  Menus
  1111.  Merkmale                               Konfiguration
  1112.  Paging                                 Prinzip
  1113.  Parameter                              Konfiguration
  1114.  Pipe Verwendung                        Pipe Verwendung
  1115.  Prinzip                                Prinzip
  1116.  Projekt                                Projekt
  1117.  Prozeße                               Prinzip
  1118.  Shell Aufruf                           Konfiguration
  1119.  Skripte                                Der ARexx Port
  1120.  Speicherverwaltung                     Prinzip
  1121.  Suchbefehle                            Suchbefehle
  1122.  Suchen                                 Suchen
  1123.  Suchen                                 Das Suchfenster
  1124.  Suchfenster                            Das Suchfenster
  1125.  Symbole                                Das Textfenster
  1126.  Tastenbefehle                          Tastenbefehle
  1127.  Textfenster                            Das Textfenster
  1128.  Titelzeile                             Das Textfenster
  1129.  ToolTypes                              Konfiguration
  1130.  Variablen                              Konfiguration
  1131.  verschlüsselte Dateien                XPK Schnittstelle
  1132.  Vorgabewerte                           Konfiguration
  1133.  Workbench Start                        Konfiguration
  1134.  
  1135.